Evaluating the GstRTMPMetadata

From RidgeRun Developer Wiki

Follow Us On Twitter LinkedIn Email Share this page






NVIDIA partner logo NXP partner logo




Requesting the Evaluation Binary

RidgeRun can provide you with an evaluation binary of the GstRTMPMetadata support to help you test it. In order to request an evaluation binary please contact us.


Features of the Evaluation

To help you test GstRTMPMetadata, RidgeRun can provide an evaluation version of the elements.

The following table summarises the features available in both the professional and evaluation version.

Feature Professional Evaluation
FLV Metadata injection (flvmux) Y Y
FLV Metadata extraction (flvdemux) Y Y
Metadata signal support Y Y
Unlimited Processing Time Y N (1)
Source Code Y N
Table 1. Features provided in the evaluation version

(1) The evaluation version will limit the processing time to a maximum of 5 minutes.

Evaluating the support

First, make sure the dependencies are fulfilled.

GStreamer

Check the current GStreamer version with the following command:

gst-launch-1.0 --version

Note: Make sure your GStreamer version matches the delivered version (e.g., 1.16.x, 1.20.x, or 1.24.x depending on your package). If you need a different version than the one provided by your system, follow the Building from source guide to install the correct one.

Eval Binary Installation

Once the requirements above are fulfilled, proceed with the installation of the tarball. RidgeRun should've provided you with the following compressed tar package:

gst-rtmp-metadata-X.Y.Z-P-J-eval.tar.gz

Extract the contents of the file with the following command:

tar -xvzf <path-to-evaluation-tar-file>

Execute the test environment configuration script:

cd gst-rtmp-metadata-X.Y.Z-P-J-eval/
./configuration.sh

Eval Binary Testing

Finally, test that the plugin is being properly picked up by GStreamer by running:

gst-inspect-1.0 flvmux
gst-inspect-1.0 flvdemux

The expected output should include the following new properties and signals in the flvmux and flvdemux elements:

  • meta-string (flvmux)
  • meta-binary (flvmux)
  • attach-flvmeta (flvdemux)
  • flv-meta-signal (flvdemux)

Example Pipelines

Please refer to the Examples page for reference pipelines.

Troubleshooting

The first level of debug to troubleshoot a failing evaluation binary is to inspect GStreamer debug output.

GST_DEBUG=2 gst-launch-1.0

If the output doesn't help you figure out the problem, please contact support@ridgerun.com with the output of the GStreamer debug and any additional information you consider useful.